home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / zipr17.zip / ZIPR.DOC < prev    next >
Text File  |  1993-01-09  |  35KB  |  786 lines
  1.                                    ZIP'R v1.7
  2.  
  3.                                        by
  4.  
  5.                    Stevenson Technical Services, Inc. (STSI)
  6.                              108 Second Avenue West
  7.                               Bertha MN 56437-0297
  8.  
  9.                              Phone: (218) 924-2050
  10.                          FAX: (218) 924-2050 (Ext. 11)
  11.                          The Bertha BBS: (218) 924-2060
  12.  
  13.  
  14. ■─────────────────────────────────────────■
  15. │               Disclaimer:               │
  16. ■─────────────────────────────────────────■
  17.  
  18.      Users of ZIP'R must accept the following disclaimer of warranty:
  19.  
  20.           "ZIP'R is supplied as is.  The author disclaims all warranties,
  21.      expressed or implied, including, without limitation, the warranties of
  22.      merchantability and of fitness for any purpose.  The author assumes no
  23.      liability for damages, direct or consequential, which may result from the
  24.      use of ZIP'R."
  25.  
  26.  
  27. ■─────────────────────────────────────────■
  28. │              Registration:              │
  29. ■─────────────────────────────────────────■
  30.  
  31.      ZIP'R is distributed under the shareware concept.  You may try ZIP'R for
  32. a period of two weeks.  After this period, you must either discontinue using
  33. ZIP'R, or register it.  For registration information, please read the
  34. REGISTER.DOC file included with ZIP'R.
  35.  
  36.  
  37. ■─────────────────────────────────────────■
  38. │           Technical Support:            │
  39. ■─────────────────────────────────────────■
  40.  
  41.      Technical support is available to ZIP'R users via The Bertha BBS.  New
  42. versions of ZIP'R will be posted here as soon as they are available.  The 
  43. Bertha BBS uses a U.S. Robotics Dual-Standard, which is capable of V.32bis, 
  44. V.32, HST, and 2400 baud connect speeds.  The access number for The Bertha BBS
  45. is (218)-924-2060.  Technical support questions should be addressed to SYSOP.
  46.  
  47.  
  48. ■─────────────────────────────────────────■
  49. │             What is ZIP'R?              │
  50. ■─────────────────────────────────────────■
  51.  
  52.      ZIP'R is a program designed to use an existing compression program, such
  53. as PKZIP/PKUNZIP, ARJ, or LHA, to automatically compress and decompress entire
  54. directories when programs are executed.
  55.  
  56.  
  57. ■─────────────────────────────────────────■
  58. │         Why was ZIP'R created?          │
  59. ■─────────────────────────────────────────■
  60.  
  61.      My business never seems to have enough hard drive space.  Even on-the-fly
  62. data compression utilities such as SuperStor and Stacker aren't sufficient,
  63. since the compression ratios achieved are not as high as any of the archiving
  64. utilities.  Since neither SuperStor or Stacker will work on a Novell file
  65. server, disk space there is especially tight.  By utilizing the
  66. network/multitasker version of ZIP'R (ZIPRN), seldom used, but necessary
  67. programs can be stored in a tightly compressed form, taking up far less hard
  68. drive space.  This effectively increases the storage capacity of the server
  69. hard drive, extending its useful life.  ZIP'R is also useful on local hard
  70. drives, even if they are already using SuperStor or Stacker.
  71.  
  72.  
  73. ■─────────────────────────────────────────■
  74. │          How does ZIP'R work?           │
  75. ■─────────────────────────────────────────■
  76.      
  77.      ZIP'R works in combination with existing compression programs to compress
  78. directories, sub-directories, and the files they contain into one smaller,
  79. compressed file on the hard drive.  This allows an entire directory filled
  80. with files to be stored in compressed form when not in use, saving a
  81. substantial amount of hard drive space.  When a program is executed, ZIP'R
  82. invokes the proper compression program to decompress the desired directory,
  83. and executes the requested program.  When the program is exited, ZIP'R invokes
  84. the chosen compression program to compress the entire directory.
  85.  
  86.  
  87. ■─────────────────────────────────────────■
  88. │  What are the benefits of using ZIP'R?  │
  89. ■─────────────────────────────────────────■
  90.  
  91.      ZIP'R can save a typical computer user a substantial amount of hard drive
  92. space.  Most users have several programs on their hard drives that are seldom
  93. used, but take up a tremendous amount of hard disk real-estate.  Rather than
  94. deleting these programs completely, ZIP'R allows these programs to be accessed
  95. when needed, storing them in a compressed form when they are not in use.  The
  96. amount of hard drive space saved depends totally on the effectiveness of the
  97. compression program used by ZIP'R.  As compression programs improve, so will
  98. the ratios that ZIP'R is able to achieve.
  99.  
  100.      The compression programs used by ZIP'R do not provide "on-the-fly" data
  101. compression.  As a result, there is a time delay during the compression and
  102. decompression processes.  However, ZIP'R does not require 50K of valuable
  103. memory, either.  In addition, ZIP'R does not degrade the performance of the
  104. computer system as the "on-the-fly" data compression programs do.
  105.  
  106.      A performance comparison of the three compression programs currently
  107. supported by ZIP'R is as follows:
  108.  
  109.      The test directory consisted of 33 files, plus a sub-directory which
  110. contained an additional 17 files.
  111.  
  112.                                                             OVERALL
  113.      COMPRESSION TYPE           BYTES       EFFICIENCY     EFFICIENCY
  114.      ------------------------------------------------------------------
  115.      Original Baseline            2,980,853         -              -
  116.      MS-DOS                       2,980,853         0%             0%
  117.      New Baseline                 2,980,853         -              0%
  118.  
  119. Additional compression obtained using ZIP'R:
  120.  
  121.      No Compression (NONE)        2,980,853         0%             0%
  122.      PKZIP 1.1 Compression (ZIP)  1,536,688        48%            48%
  123.      PKZIP 2.0 Compression (ZIP)  1,401,026        53%            53%
  124.      LHA Compression (LHA)        1,428,393        52%            52%
  125.      ARJ Compression (ARJ)        1,406,625        53%            53%
  126.  
  127.  
  128.                                                             OVERALL
  129.      COMPRESSION TYPE           BYTES       EFFICIENCY     EFFICIENCY
  130.      ------------------------------------------------------------------
  131.      Original Baseline            2,980,853         -              -
  132.      DRDOS w/SuperStor            1,992,704        33%            33%
  133.      New Baseline                 1,992,704         -             33%
  134.  
  135. Additional compression obtained using ZIP'R:
  136.  
  137.      No Compression (NONE)        1,992,704         0%            33%
  138.      PKZIP 1.1 Compression (ZIP)  1,551,360        22%            48%
  139.      PKZIP 2.0 Compression (ZIP)  1,408,512        29%            53%
  140.      LHA Compression (LHA)        1,444,864        27%            52%
  141.      ARJ Compression (ARJ)        1,423,872        29%            52%
  142.  
  143.  
  144. ■─────────────────────────────────────────■
  145. │            Installing ZIP'R:            │
  146. ■─────────────────────────────────────────■
  147.  
  148.      The first step in testing a new piece of software is to perform a backup
  149. and test its integrity.  Since ZIP'R will compress entire directories into a
  150. single file, your potential losses are much greater if this file becomes lost
  151. or corrupted.
  152.  
  153.      Create a C:\ZIPR sub-directory and extract all of the ZIP'R related files
  154. into this sub-directory.  (The single-user version of ZIP'R will only work when
  155. executed from the C: drive.)  Copy the compression program(s) of your choice
  156. into this sub-directory.  If you decide to use PKZip, you need the files
  157. PKZIP.EXE and PKUNZIP.EXE.  If you use ARJ, you need the file ARJ.EXE.  If you
  158. use LHA, you need the file LHA.EXE.  ZIP'R has been tested with PKZip version
  159. 1.10, ARJ version 2.30, and LHA version 2.13.  ARJ consistently provides the
  160. tightest archives, but is not nearly as fast as ZIP.  ARJ also has the ability
  161. to test the integrity of the archive, which is useful when running ZIP'R under
  162. a multitasker, such as DESQview or Windows.  (Since my company uses PKZip 
  163. internally, more extensive testing has been performed with ZIP than with ARJ 
  164. or LHA.)  Preliminary testing has begun with PKZIP v2.04c.
  165.  
  166.      The network/multitasker version of ZIP'R (ZIPRN.EXE) can be installed on 
  167. any drive in your system, including network drives.  Be sure to include a      
  168. SET ZIPR=N:\ZIPR statement (or wherever you put ZIP'R), in your AUTOEXEC.BAT 
  169. file.  If this environment variable is not found, ZIPRN.EXE defaults to using 
  170. the C:\ZIPR sub-directory.  
  171.  
  172.  
  173. ■─────────────────────────────────────────■
  174. │              Using ZIP'R:               │
  175. ■─────────────────────────────────────────■
  176.  
  177.      ZIP'R operates by using command line parameters.  To run a program using
  178. ZIP'R, you must know the directory in which it resides and the name of the
  179. file to be executed.  (This must be a file with a .COM, .EXE, or a .BAT
  180. extension.)  You must also decide whether to compress the program's sub-
  181. directory after execution.  If you choose to use the compression feature, you
  182. must choose between ZIP, ARJ, or LHA, depending on which program you own.  The
  183. ZIP'R command line structure looks like this:
  184.  
  185.      ZIPR(N) DRIVE: \PATH ZIPNAME COMPRESSION FILENAME P1 P2 P3 P4
  186.  
  187.  
  188. ZIPR(N)     - ZIPR should always be the first entry entered on the command
  189.               line.  All command line entries should be in UPPER CASE, and
  190.               should be separated by a single space.  If you are using the
  191.               network/multitasker version of ZIP'R, this entry should be ZIPRN.
  192.  
  193.  
  194. DRIVE:      - This entry should contain the drive letter (with colon) of the
  195.               drive containing the program to be executed.
  196.  
  197.  
  198. \PATH       - This entry should contain the path to the program that will be
  199.               executed.  (The backslash is required!)  Do NOT specify the root
  200.               directory, or you could compress your entire hard disk into one
  201.               file, which would cause your hard drive to be unbootable.
  202.  
  203.  
  204. ZIPNAME     - This is the name of the compressed file that will be created or
  205.               used by ZIP'R.  Normally, this is the sub-directory name, but
  206.               this is not a requirement.  Do NOT enter an extension after the
  207.               ZIPNAME.  ZIP'R will automatically append the proper extension,
  208.               depending on the type of compression selected.
  209.  
  210.  
  211. COMPRESSION - This entry specifies the type of compression that ZIP'R will
  212.               attempt to use.  Valid choices are ZIP, ARJ, LHA, or NONE.  If
  213.               NONE is selected, ZIP'R will decompress an existing compressed
  214.               file prior to executing the desired program, but will not
  215.               compress the directory after the program is exited.
  216.  
  217.               Additional ARJ options:
  218.  
  219.                    ARJT  =  Test archive integrity before deleting files.
  220.                    ARJ0  =  ARJ -m0 switch.
  221.                    ARJ1  =  ARJ -m1 switch.
  222.                    ARJ2  =  ARJ -m2 switch.
  223.                    ARJ3  =  ARJ -m3 switch.
  224.                    ARJ4  =  ARJ -m4 switch.
  225.                    ARJ5  =  ARJ -m1 -jm switches.
  226.                    ARJ6  =  ARJ -m2 -jm switches.
  227.                    ARJ7  =  ARJ -m1 -jm1 switches.
  228.                    ARJ8  =  ARJ -m2 -jm1 switches.
  229.  
  230.  
  231.                    These figures were generated with ARJ 2.30.
  232.  
  233.                                No Compression       ARJ Results   Compression
  234.                    ARJ0           2,980,853           2,983,500        0%
  235.                    ARJ1           2,980,853           1,406,625       53%
  236.                    ARJ2           2,980,853           1,414,245       53%
  237.                    ARJ3           2,980,853           1,444,400       52%
  238.                    ARJ4           2,980,853           1,593,074       47%
  239.                    ARJ5           2,980,853           1,403,524       53%
  240.                    ARJ6           2,980,853           1,403,524       53%
  241.                    ARJ7           2,980,853           1,404,949       53%
  242.                    ARJ8           2,980,853           1,404,949       53%
  243.  
  244.  
  245.               ARJT is used to provide an extra level of assurance that the
  246.               files have been stored correctly in the archive.  When this
  247.               switch is used, ARJ will verify the integrity of the archive
  248.               before deleting any files.  Other ARJ options may be used to
  249.               choose less compression in exchange for more speed, or more
  250.               compression in exchange for less speed.  The default ARJ
  251.               compression setting is to use the -m1 switch.  (Use ARJ or
  252.               ARJ1.)
  253.  
  254.  
  255.               Additional ZIP options:
  256.  
  257.                    ZIP0 = ZIP -e0 switch.  (PKZIP 2.0 Only)
  258.                    ZIP1 = ZIP -es switch.  (PKZIP 1.1 or 2.0)
  259.                    ZIP2 = ZIP -ef switch.  (PKZIP 2.0 Only)
  260.                    ZIP3 = ZIP -en switch.  (PKZIP 2.0 Only)
  261.                    ZIP4 = ZIP -ex switch.  (PKZIP 1.1 or 2.0)
  262.  
  263.  
  264.                    These figures were generated using PKZIP 2.04c.
  265.  
  266.                                No Compression       ZIP Results   Compression
  267.                    ZIP0           2,980,853           2,985,751        0%
  268.                    ZIP1           2,980,853           1,535,935       48%
  269.                    ZIP2           2,980,853           1,432,248       52%
  270.                    ZIP3           2,980,853           1,401,026       53%
  271.                    ZIP4           2,980,853           1,392,625       53%
  272.  
  273.  
  274.               These options may be used to trade lower compression for
  275.               greater speed and vice versa.
  276.  
  277.               In addition to these options, additional parameters may be added
  278.               to the PKZIP command line to solve specific problems.  These
  279.               extra parameters are as follows:
  280.  
  281.               3  ->  Disable 32-bit Instruction Usage.
  282.               )  ->  Disable DPMI Support.
  283.               (  ->  Use "Slow" MemCopy.
  284.               +  ->  Disable EMS Usage.
  285.               -  ->  Disable XMS/UMB Usage.
  286.               ~  ->  Disable Network Detection.
  287.  
  288.               Each of these paramaters is explained completely in the 
  289.               troubleshooting section of the PKZIP documentation.
  290.  
  291.               The format that must be used to pass these parameters to ZIP'R 
  292.               is ZIP-??.  The question marks should be replaced by a two digit 
  293.               code chosen from the following table.  The code is selected based
  294.               on the combination of parameters necessary to run PKZIP reliably 
  295.               on your machine.  For example, to disable 32-bit instruction 
  296.               usage and use "slow" memcopy, the code "07" would be chosen.  The
  297.               command line parameter for ZIP'R would be ZIP-07.
  298.               
  299.  
  300.                            ZIP'R / PKZIP v2.0 Parameter Matrix
  301.               ┌──────────────┬──────────────┬──────────────┬──────────────┐
  302.               │ 00 >  3      │ 10 >  3(-    │ 20 >  3)(+~  │ 30 >  )(+~   │
  303.               │ 01 >  )      │ 11 >  3(~    │ 21 >  3)(-~  │ 31 >  )(-~   │
  304.               │ 02 >  (      │ 12 >  3+-    │ 22 >  3)+-~  │ 32 >  )(+-~  │
  305.               │ 03 >  +      │ 13 >  3+~    │ 23 >  3(+-~  │ 33 >  (+     │
  306.               │ 04 >  -      │ 14 >  3-~    │ 24 >  3)(+-~ │ 34 >  (-     │
  307.               │ 05 >  ~      │ 15 >  3)(+   │ 25 >  )(     │ 35 >  (~     │
  308.               │ 06 >  3)     │ 16 >  3)(-   │ 26 >  )+     │ 36 >  (+-    │
  309.               │ 07 >  3(     │ 17 >  3)(~   │ 27 >  )-     │ 37 >  (+~    │
  310.               │ 08 >  3+     │ 18 >  3)+-   │ 28 >  )~     │ 38 >  (-~    │
  311.               │ 09 >  3-     │ 19 >  3)+~   │ 29 >  )(+    │ 39 >  (+-~   │
  312.               │ 0A >  3~     │ 1A >  3)-~   │ 2A >  )(-    │ 3A >  +-     │
  313.               │ 0B >  3)(    │ 1B >  3(+-   │ 2B >  )(~    │ 3B >  +~     │
  314.               │ 0C >  3)+    │ 1C >  3(+~   │ 2C >  )+-    │ 3C >  +-~    │
  315.               │ 0D >  3)-    │ 1D >  3(-~   │ 2D >  )+~    │ 3D >  -~     │
  316.               │ 0E >  3)~    │ 1E >  3+-~   │ 2E >  )-~    │              │
  317.               │ 0F >  3(+    │ 1F >  3)(+-  │ 2F >  )(+-   │              │
  318.               └──────────────┴──────────────┴──────────────┴──────────────┘
  319.  
  320.  
  321. FILENAME    - This entry should contain the name of the file to be executed.
  322.               Do NOT specify an extension.  ZIP'R checks for the existence of
  323.               a .BAT, .COM, or .EXE file and executes it.
  324.  
  325.  
  326. P1          - This entry is optional, and contains the first parameter to be
  327.               passed to the program being executed.
  328.  
  329.  
  330. P2          - This entry is optional, and contains the second parameter to be
  331.               passed to the program being executed.
  332.  
  333.  
  334. P3          - This entry is optional, and contains the third parameter to be
  335.               passed to the program being executed.
  336.  
  337.  
  338. P4          - This entry is optional, and contains the fourth parameter to be
  339.               passed to the program being executed.
  340.  
  341.  
  342.      ZIP'R Examples:
  343.  
  344.           ZIPR C: \PFS PFS ZIP PW
  345.           ZIPR C: \PCTOOLS PCTOOLS ZIP PCSHELL /LCD
  346.           ZIPR C: \PCTOOLS PCTOOLS ZIP-07 PCSHELL
  347.           ZIPR C: \PCTOOLS PCTOOLS ARJ DESKTOP
  348.           ZIPR C: \PCTOOLS PCTOOLS NONE SI
  349.           ZIPR C: \PSDELUXE DELUXE LHA PSD
  350.  
  351.  
  352.      ZIP'R (Network/Multitasker) Examples:
  353.  
  354.           ZIPRN C: \PFS PFS ZIP PW
  355.           ZIPRN C: \PCTOOLS PCTOOLS ZIP PCSHELL /LCD
  356.           ZIPRN C: \PCTOOLS PCTOOLS ZIP-07 PCSHELL
  357.           ZIPRN C: \PCTOOLS PCTOOLS ARJ DESKTOP
  358.           ZIPRN C: \PCTOOLS PCTOOLS NONE SI
  359.           ZIPRN C: \PSDELUXE DELUXE LHA PSD
  360.  
  361.  
  362. ■─────────────────────────────────────────■
  363. │     Using ZIP'R with a menu system:     │
  364. ■─────────────────────────────────────────■
  365.  
  366.      To use ZIP'R with a menu system, you must modify the location and program
  367. name specified for each program that will be run through ZIP'R.
  368.  
  369.      QuikMenu Example:
  370.  
  371.           OLD     Location:  C:\PFS
  372.                   Command:   PW
  373.  
  374.           NEW     Location:  C:\ZIPR
  375.                   Command:   ZIPR C: \PFS PFS ZIP PW
  376.  
  377.      
  378.      AutoMenu Example:
  379.  
  380.           OLD     C:
  381.                   CD\PFS
  382.                   PW
  383.                   CD\
  384.                   AUTO
  385.  
  386.           NEW     C:
  387.                   CD\ZIPR
  388.                   ZIPR C: \PFS PFS ZIP PW
  389.                   CD\
  390.                   AUTO
  391.  
  392.      
  393.      All programs that are executed through ZIP'R must have C:\ZIPR specified
  394. as the path.  The actual location of the program to be executed is specified
  395. on the ZIP'R command line, as shown above.  ZIP'R automatically changes to
  396. this directory before executing the desired program.  The network/multitasker
  397. version of ZIP'R (ZIPRN.EXE) may be located on any drive, or in any sub-
  398. directory desired.
  399.  
  400.  
  401. ■─────────────────────────────────────────■
  402. │        Advanced ZIP'R features:         │
  403. ■─────────────────────────────────────────■
  404.  
  405.      ZIP'R versions 1.5 and above have the ability to execute a series of
  406. commands before and after the desired program is executed.  This feature is 
  407. useful for flushing and disabling a cache or swapping a printer port prior to 
  408. executing a particular program.  After the program is executed, the cache can 
  409. be enabled or the printer ports can be returned to their original settings.
  410.  
  411.      In order to use this feature of ZIP'R, two files must be created in the
  412. \ZIPR sub-directory.  The file containing the commands to be executed prior to
  413. the desired program must have a .IN extension.  This extension indicates that
  414. the commands in this file are to be used when going "IN" to the program.  The 
  415. file containing the commands to be executed after the desired program is exited
  416. must have a .OUT extension.  This extension indicates that the commands in this 
  417. file are to be used when going "OUT" of the program.  The filename of the .IN 
  418. and .OUT files must match the ZIPNAME for the desired program on the ZIP'R 
  419. command line.  The commands within this file should specify the full path to 
  420. the desired program, unless the program is available on the path.
  421.  
  422.      To illustrate this concept more clearly, I will use two real-world 
  423. examples from my own business.  Since my business uses a Novell network, I use
  424. the network/multitasker version of ZIP'R (ZIPRN).  I run a program called 
  425. Stowaway, which archives seldom-used files off-line.  If Stowaway is run with 
  426. floppy disk caching enabled, Stowaway can't reliably verify the data written to 
  427. the floppy disk.  To circumvent this problem, the cache must be flushed and 
  428. disabled prior to executing Stowaway, and enabled after Stowaway is finished.  
  429. The command line used to execute Stowaway through ZIP'R looks like this:
  430.  
  431.      ZIPRN N: \STOWAWAY STOWAWAY ZIP STOW
  432.  
  433.      Since the ZIPNAME here is "STOWAWAY", the first file would be called
  434. STOWAWAY.IN, and the second file would be called STOWAWAY.OUT.  The contents
  435. of STOWAWAY.IN are as follows:
  436.  
  437.      C:\PCKWIK\SUPERPCK /F /D
  438.  
  439.      This command line is executed by ZIP'R prior to executing Stowaway,
  440. flushing and disabling the cache.  After Stowaway exits, the commands in
  441. STOWAWAY.OUT are executed.  STOWAWAY.OUT contains the following commands:
  442.  
  443.      C:\PCKWIK\SUPERPCK /E
  444.  
  445.      This command line simply enables the cache, without changing any of its
  446. parameters.
  447.  
  448.      
  449.      The second example involves QmodemPro.  I use the DOS 5 editor instead of
  450. the QmodemPro editor.  My computer accesses printers via a Novell network.  The 
  451. network is set up with a laser printer as LPT1: and a dot-matrix printer as 
  452. LPT2:.  Unfortunately, the DOS 5 editor does not have the capability of 
  453. printing to LPT2:.  To circumvent this problem, the Novell CAPTURE utility is
  454. used to change the printer port queue assignments.  My QmodemPro command line 
  455. is as follows:
  456.  
  457.      ZIPRN N: \QMPRO QMPRO NONE QMPRO
  458.  
  459.      Since the ZIPNAME here is "QMPRO", the two files that need to be created
  460. are QMPRO.IN and QMPRO.OUT.  The contents of QMPRO.IN are as follows:
  461.  
  462.      CAPTURE /L=1 /Q=PRINTQ_2 /NB /TI=10
  463.  
  464.      This command routes the LPT1: information to PRINTQ_2, which is the queue
  465.  for the dot-matrix printer on the server.
  466.      
  467.      The contents of QMPRO.OUT are as follows:
  468.  
  469.      CAPTURE /L=1 /Q=PRINTQ_1 /NB /TI=10
  470.  
  471.      This command routes the LPT1: information back to PRINTQ_1, which is the
  472. queue for the laser printer on the server.  Notice in this example that ZIP'R 
  473. is not being used to compress this particular program.  
  474.  
  475.  
  476. ■─────────────────────────────────────────■
  477. │       Using ZIP'R with DESQview:        │
  478. ■─────────────────────────────────────────■
  479.  
  480.      ZIP'R has been tested under DESQview.  However, caution is advised since
  481. it is possible under any multi-tasker to have two or more windows attempting
  482. to compress or decompress the same file at the same time.  This scenario can
  483. cause data corruption.  The network/multitasker version of ZIP'R (ZIPRN.EXE)
  484. has additional features which limit simultaneous access during the compression
  485. and decompression phases.
  486.  
  487.      DESQview .DVP Example:
  488.  
  489.           OLD   Program...: PW
  490.  
  491.                 Parameters:
  492.  
  493.                 Directory.: C:\PFS
  494.  
  495.  
  496.           NEW   Program...: ZIPRN
  497.  
  498.                 Parameters: C: \PFS PFS ZIP PW
  499.  
  500.                 Directory.: C:\ZIPR
  501.  
  502.      
  503.      If you are a TAME user, copy the files TAME-RES.COM, and TAME.EXE into 
  504. the ZIP'R subdirectory.  Use the ZIPRTAME.BAT file supplied with ZIP'R to
  505. invoke TAME-RES.COM before executing ZIP'R.  To run the previous example 
  506. program, the .DVP command lines would be changed as shown below:
  507.  
  508.      DESQview .DVP Example (Invoking TAME):
  509.  
  510.           OLD   Program...: ZIPRN
  511.  
  512.                 Parameters: C: \PFS PFS ZIP PW
  513.  
  514.                 Directory.: C:\ZIPR
  515.  
  516.  
  517.           NEW   Program...: ZIPRTAME
  518.  
  519.                 Parameters: ZIPRN C: \PFS PFS ZIP PW
  520.  
  521.                 Directory.: C:\ZIPR
  522.  
  523.      
  524.      Since ZIPRTAME.BAT is a batch file containing an EXIT statement, you 
  525. should also make the following change to your .DVP:
  526.  
  527.      Change a Program Advanced Options
  528.   
  529.      OLD     Close on exit (Y,N,blank)......: [Y]
  530.  
  531.      NEW     Close on exit (Y,N,blank)......: [N]
  532.  
  533.  
  534.      This change allows control to return to the ZIPRTAME.BAT file after ZIP'R
  535. completes its operation.
  536.  
  537.      ZIPRTAME.BAT is a modified TAME-RUN.BAT batch file containing the proper
  538. paths to TAME-RES.COM and TAME.EXE.  Stay tuned!  There will be more ZIP'R
  539. enhancements working in combination with TAME.
  540.  
  541.  
  542. ■─────────────────────────────────────────■
  543. │       DESQview Tips & Techniques:       │
  544. ■─────────────────────────────────────────■
  545.  
  546.      Allocating a small amount (about 150K) of EMS memory to programs executed
  547. through ZIP'R will allow ZIP'R to swap itself to EMS memory, rather than disk.
  548. This speeds up the swapping process somewhat.  If you are already allocating
  549. EMS memory to the program, increasing the amount by 150K will provide extra
  550. room for the swap file.
  551.      
  552.      The opening ZIP'R screen will indicate how much EMS memory is available
  553. to ZIP'R.  If this figure is less than 150K, increase the amount of EMS memory
  554. allocated.
  555.  
  556.      Since PKZIP 2.0 can also use EMS memory, additional memory should be set
  557. aside as swap space for PKZIP.  
  558.  
  559.      When using ZIPRN (without TAME), you can save about 8K of memory by 
  560. specifying the .EXE extension for ZIPRN as shown in the following example: 
  561.      
  562.      DESQview .DVP Example (Saves about 8K of memory.):
  563.  
  564.           OLD   Program...: ZIPRN
  565.  
  566.                 Parameters: C: \PFS PFS ZIP PW
  567.  
  568.                 Directory.: C:\ZIPR
  569.  
  570.      
  571.           NEW   Program...: ZIPRN.EXE
  572.  
  573.                 Parameters: C: \PFS PFS ZIP PW
  574.  
  575.                 Directory.: C:\ZIPR
  576.  
  577.      This saves about 8K of memory by allowing DESQview to execute ZIP'R 
  578. directly, rather than loading a secondary command processor.     
  579.  
  580.  
  581. ■─────────────────────────────────────────■
  582. │        Using ZIP'R with Windows:        │
  583. ■─────────────────────────────────────────■
  584.  
  585.      ZIP'R is only effective when running DOS programs under Windows.  It will
  586. NOT work with Windows specific programs!
  587.  
  588.      ZIP'R has been tested under Windows, but the same cautions that apply to
  589. DESQview apply to Windows.  Since Windows is a multi-tasker, it is possible to
  590. have two or more windows attempting to compress or decompress the same file
  591. at the same time.  This scenario can cause data corruption.  The
  592. network/multitasker version of ZIP'R (ZIPRN.EXE) has additional features which
  593. limit simultaneous access during the compression and decompression phases.
  594.  
  595.      Windows Program Item Properties Example:
  596.  
  597.           OLD   Description:        PFS Pro-Write
  598.                 Command Line:       PW
  599.                 Working Directory:  C:\PFS
  600.  
  601.           NEW   Description:        PFS Pro-Write
  602.                 Command Line:       ZIPRN C: \PFS PFS ZIP PW
  603.                 Working Directory:  C:\ZIPR
  604.  
  605.  
  606.      Windows .PIF Example:
  607.  
  608.           OLD   Program Filename:     PW.COM
  609.                 Window Title:         PFS Pro-Write
  610.                 Optional Parameters:
  611.                 Start-up Directory:   C:\PFS
  612.  
  613.           NEW   Program Filename:     ZIPRN.EXE
  614.                 Window Title:         PFS Pro-Write
  615.                 Optional Parameters:  C: \PFS PFS ZIP PW
  616.                 Start-up Directory:   C:\ZIPR
  617.  
  618.  
  619.      TAME may also be used in combination with ZIP'R under Windows.  If you 
  620. are a TAME user, copy the files TAME-RES.COM, and TAME.EXE into the ZIP'R 
  621. subdirectory.  Use the ZIPRTAME.BAT file supplied with ZIP'R to invoke 
  622. TAME-RES.COM before executing ZIP'R.  To run the previous example program, 
  623. the Windows command lines would be changed as shown below:
  624.  
  625.  
  626.      Windows Program Item Properties Example (Invoking TAME):
  627.  
  628.           OLD   Description:        PFS Pro-Write
  629.                 Command Line:       ZIPRN C: \PFS PFS ZIP PW
  630.                 Working Directory:  C:\ZIPR
  631.  
  632.           NEW   Description:        PFS Pro-Write
  633.                 Command Line:       ZIPRTAME ZIPRN C: \PFS PFS ZIP PW
  634.                 Working Directory:  C:\ZIPR
  635.  
  636.  
  637.      Windows .PIF Example (Invoking TAME):
  638.  
  639.           OLD   Program Filename:     ZIPRN.EXE
  640.                 Window Title:         PFS Pro-Write
  641.                 Optional Parameters:  C: \PFS PFS ZIP PW        
  642.                 Start-up Directory:   C:\ZIPR
  643.  
  644.           NEW   Program Filename:     ZIPRTAME.BAT
  645.                 Window Title:         PFS Pro-Write
  646.                 Optional Parameters:  ZIPRN C: \PFS PFS ZIP PW
  647.                 Start-up Directory:   C:\ZIPR
  648.  
  649.  
  650. ■─────────────────────────────────────────■
  651. │        Using ZIP'R with DoorWay:        │
  652. ■─────────────────────────────────────────■
  653.  
  654.      ZIP'R has been tested in combination with DoorWay.  However, the command
  655. line structure must be changed slightly.  DoorWay requires the .EXE extension
  656. to appear on the command line.  An example of an actual DoorWay command line
  657. is as follows:
  658.  
  659.           /P:C:\ZIPR\ZIPR.EXE D: \THEDRAW THEDRAW ZIP THEDRAW
  660.  
  661.  
  662. ■─────────────────────────────────────────■
  663. │                Cautions!                │
  664. ■─────────────────────────────────────────■
  665.  
  666.      Do NOT attempt to use ZIP'R to compress any directories containing files
  667. that are referenced in your CONFIG.SYS or AUTOEXEC.BAT.  If you wish to
  668. compress the DOS sub-directory, copy any such files to the root directory of
  669. the hard drive, and update the paths in your CONFIG.SYS and AUTOEXEC.BAT.
  670. Also be cautious when compressing directories that contain memory managers,
  671. caches, and utilities that may be needed to boot your machine.  These
  672. directories may be compressed, but any files needed for booting the machine
  673. must be copied to the root directory, and the CONFIG.SYS and AUTOEXEC.BAT
  674. paths updated.
  675.  
  676.      Keep in mind that in order to properly decompress a program, there must
  677. be enough free space on the hard drive to contain all the extracted files in
  678. addition to the original compressed file.  After the files have been
  679. successfully extracted, the compressed file is deleted.  Likewise, when
  680. compressing a program, sufficient space must be available for the original
  681. program files and the newly created compressed file.  After the compressed
  682. file has been successfully created, the original program files are deleted.
  683.  
  684.      Multitaskers such as DESQview and Windows put additional stress on the
  685. disk I/O systems of the computer.  If you have any doubts about the stability
  686. of your system, either don't use ZIP'R in the first place, or use the ARJT
  687. option to force ARJ to verify the integrity of the archive before files are
  688. deleted.  When running on a network, or using a multitasker, ZIPRN should be
  689. used to reduce conflicts when compressing and decompressing files.
  690.  
  691.      When upgrading to PKZIP 2.0, test the reliability of the compression and
  692. decompression processes before trusting it with your data!  PKZIP 2.0 has some
  693. documented problems with fast machines (486/25 and up) using external CPU 
  694. memory caches.  Read the troubleshooting section of the PKZIP 2.0 documentation
  695. for more information.
  696.  
  697.  
  698. ■─────────────────────────────────────────■
  699. │   Troubleshooting / Common Problems:    │
  700. ■─────────────────────────────────────────■
  701.  
  702. Problem #1:     
  703.  
  704.      The most common problem among ZIP'R users is incorrect command line
  705. parameters.  In order to effectively use ZIP'R, you need to know five things:
  706.      
  707.      1.  The drive that the program you wish to run is located on.
  708.      2.  The directory that the program you wish to run is located in.
  709.      3.  The name of the compressed file that will be created or used.
  710.      4.  The type of compression you want to use.
  711.      5.  The name of the executable file that you want to run.
  712.  
  713.      As an example, suppose that you want to run the program PCSHELL.EXE, 
  714. which is located in the PCTOOLS sub-directory on the D: drive.  After this
  715. program is executed, you want the entire PCTOOLS sub-directory (and all of 
  716. its sub-directories) compressed using PKZIP.  Fill in the required five 
  717. parameters as follows:
  718.  
  719.      1.  D:  (Colon required.)
  720.      2.  \PCTOOLS  (Backslash required.)
  721.      3.  PCTOOLS (This is a name you make up.  No extension.)
  722.      4.  ZIP (This is the type of compression you want to use.)
  723.      5.  PCSHELL (No extension.  ZIP'R searches for an executable file.)
  724.  
  725.      So, in this example the final ZIP'R command line would be:
  726.  
  727.      ZIPR D: \PCTOOLS PCTOOLS ZIP PCSHELL
  728.  
  729.      If you were using the network/multitasker version of ZIP'R (ZIPRN), the
  730. command line would be:     
  731.  
  732.      ZIPRN D: \PCTOOLS PCTOOLS ZIP PCSHELL
  733.  
  734.  
  735. Problem #2:
  736.  
  737.      If you receive the error message, "Unable to run COMMAND /C ...", you 
  738. are probably running DR DOS, and do not have COMMAND.COM available on your
  739. path.  For some reason, DR DOS does not copy COMMAND.COM into the \DRDOS
  740. sub-directory at installation time, making it unavailable on the path.  The
  741. solution here is simply to copy COMMAND.COM from the root directory into the
  742. \DRDOS sub-directory.  Another alternative is to add the root directory to
  743. the PATH= statement in the AUTOEXEC.BAT file.
  744.      
  745.      Version 1.7 of ZIP'R detects this problem and issues a warning message.
  746.  
  747.  
  748. Problem #3:
  749.  
  750.      If ZIP'R won't compress the program's files and sub-directories after it
  751. is exited, check the ZIP'R command line parameters.  If these are all correct,
  752. check the \ZIPR sub-directory for any files with a .U00 or .U01 extension.  
  753. These are token files created by ZIPRN to track concurrent access to a 
  754. compressed file.  Normally, these files are deleted when the program is exited.  
  755. However, if the computer hangs, these files will not be deleted, and will 
  756. prevent ZIP'R from compressing the program's files and sub-directories.  The 
  757. filename will match the name given to the compressed file on the ZIP'R command 
  758. line.  For example, the command line "ZIPRN C: \PCTOOLS6 PCTOOLS6 ZIP PCSHELL" 
  759. would create a file called PCTOOLS6.U00 or PCTOOLS6.U01.  To make ZIP'R operate 
  760. correctly, make sure that the program is not being used, and delete either or
  761. both of these files from the \ZIPR sub-directory.
  762.  
  763.  
  764. Problem #4:
  765.  
  766.      If you are using PKZIP v2.04c, and are getting unexplained CRC errors
  767. during compression and decompression, use the ZIP-02 switch on the ZIP'R 
  768. command line to force PKZIP to use "Slow MemCopy".  This problem is explained
  769. in the troubleshooting section of the PKZIP documentation.
  770.  
  771.  
  772. ■─────────────────────────────────────────■
  773. │           Programs mentioned:           │
  774. ■─────────────────────────────────────────■
  775.  
  776. TAME is copyrighted by PowerSoft, Inc. and David G. Thomas.
  777. ARJ is copyrighted by Robert K Jung.
  778. AutoMenu is copyrighted by Magee Enterprises.
  779. DESQview is copyrighted by Quarterdeck Office Systems.
  780. DoorWay is copyrighted by Marshall Dudley.
  781. LHA is copyrighted by Haruyasu Yoshizaki.
  782. PKZIP is copyrighted by PKWARE, Inc.
  783. PKUNZIP is copyrighted by PKWARE, Inc.
  784. QuikMenu is copyrighted by OSCS Software Development, Inc.
  785. Windows is copyrighted by Microsoft.
  786.